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Dear Reader, 


It is my hope to create an easy to understand handbook for using the 
Peercast software. 


If you find the Peercast software useful, please make a donation to defray the 
cost of continued improvements and research. You can make your donation 
on the Peercast web site, www.peercast.org. 


Special thanks goes to Giles Goddard as the developer of the Peercast 
streaming software. 


Additional thanks goes to the following people who helped make Peercast 
successful: 


Justin Frankel of Nullsoft for developing the Gnutella protocol. 
HendrikMans for creating the broadcast tutorials 

Jstar for helping with NSV Video documentation. 

Nogwater, Wsuff and all of the contributors at the Peercast forums. 
Open source software developers everywhere. 

You the broadcast and user. 


Be Seeing You 


David Childers 
June 2003 


“Computers are useless. They can only give you answers.” 
Pablo Picasso (1881-1973) 


Introduction to Peercast 


Peercast is an open source method of Internet broadcasting. It is based upon 
the Gnutella peer-to-peer file trading protocol. 


What makes Peercast so revolutionary is that the content is distributed using 
a peer-to-peer protocol that requires no central server for data distribution. 


The standard Internet broadcast method uses the unicast system of data 
distribution. This requires an individual data stream to be sent to each 
individual client requesting the broadcast. A central server to distribute the 
data is needed as well. 


Multicast (Mbone) was developed as a method to enhance data distribution 
on an extended scale. This requires the use of specialized network 
equipment and software. Data is transferred from client to client without the 
use of central server architecture. This method has not been universally 
deployed due to cost and technical considerations. 


The Napster music file trading frenzy made peer to peer famous. This 
technique allowed users to trade files without the need for large bandwidth 
requirements or exotic network equipment. A central server was required 


Gnutella was the next step in the peer-to-peer revolution. Gnutella requires 
no central server for data communication. 


Peercast combines the best of peer-to-peer technology and multimedia 
delivery all into a wonderful open source package. 


Now anyone can create his or her own radio or television station without the 
need for expensive bandwidth or server software. 


Audio broadcasting 


MP3 format 


Here is a complete step-by-step guide for setting up Peercast to broadcast in 
MP3 format. Windows operating system. 


Download the Winamp media player software 
(It is recommended that you install the full version.) 
www.winamp.com 


Install it. 


Download the Shoutcast DSP plugin 
http://www.shoutcast.com/download/broadcast.phtml 


Install it. 


Run Winamp 


Open preferences 














Winamp Preferences 


Double click on Shoutcast 
source DSP 


DSP [dsp_oddcast all 
Nulsoft SHOUTcast Source OSP ¥1.8,2b [dsp_se.dl] 





A window for the Shoutcast DSP 
Source will open 





Under the output tab 


The following entries should be 
made 


Address : localhost 

Port Number : 7145 

Encoder Number : 1 (Default) 
(Number of encoders that you are 
running.) 


Under the encode tab 


Select MP3 Encode as the 
encode type. 


Select the appropriate stream 
Rate under encoder settings. 
(See Best Broadcasting Practices) 


SHOUTcast S 





ource 





SHOUTcast Source 


Under Input tab 


Select Winamp for your input device. 





Start Winamp 


Double check that Peercast is running. 
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Test your stream by listening to it in Winamp by clicking on the Play button 
on my Relayed channels page. 


http://localhost:7144/admin?page=mychans 
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Ogg Vorbis format 


Here is a complete step by step guide for setting up Peercast to broadcast in 
Ogg Vorbis format. Windows operating system. 

( Compiled by Nogwater ) 

Download the winamp media player software 

www.winamp.com 

(It is recommended that you install the full version.) 

Install it. 


Download the Oddcast software from here: 
http://www.oddsock.org/tools/dsp_oddcast 


Install it. 


Run winamp 


Open preferences 











Winamp Preferences x! 


Double click on Oddcast DSP. —DSP/Effect plug-in 






















Setup 
File lypes 
Agent | Joddeast DSP [dsp_oddcast dll] 

Options 
Display 
Visueleation 
Shulfle 
Video 
Library 

Plugins 
Inout 
Output 
Visualeation 
General Purpose 

Skins 


Bookmarks >] 














A window for Oddcast will open. 


Click the Config Button in the Oddcast window. 
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Switch from LAME to Ogg Vorbis. 
Set the selection to Quality. 
St the value to 1 





Icecast 2 

Server: localhost 

Port: 7144 

Password: (Same as Peercast) 
Check the list on YP box. 





Under Server Information, enter your information; be sure to enter a mount 
point. 


Descirption — About your station. 
Genre - Type of programming. 
URL —- Home page of station. 
Mountpoint /channelname.ogg 





10 
Click OK. 
Double check that Peercast is running. 
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Click Connect on the Oddcast 
window. 





If everything is configured you will be broadcasting. 


Test your stream by listening to it in Winamp by clicking on the Play button 
on my Relayed channels page. 


http://localhost:7144/admin?page=mychans 
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Note: 
No adjustments were made to lame. 
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Video broadcasting 
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NSV 
Thanks to Jstar and Giles for helping with this information. 
Initial documentation for NSV using Shoutcast was documented by SAWG - 
http://forums.winamp.com/ 
Windows operating system. 
Download the following software: 
NSV video tools - http://www. nullsoft.com/nsv 
Peercast - http://www.peercast.org/download.php 
Setting up NSV 
A header.txt needs to be created for broadcasting. 


Create a text file called headers.txt. This file must be saved in the NSVtools 
folder (C:\Program Files\NSVtools\ by default). 


This file must contain the following information: 


content-type:video/nsv 
icy-metadata:0 
icy-name:My NSV Stream 
icy-genre:Video 

icy-pub:0 

icy-br:128 


icy-url:http://www.com 
icy-irc:#chan 
icy-icq:1234567 
icy-aim:SomeUser 
icy-reset:1 





Important Note 


The following information is for running both the NSV tools and Peercast on 
the same computer, thus the use of "localhost". 


If you are not running NSV and Peercast on the same computer, substitute 
localhost with the IP address of the computer hosting the other software 
system. ( Either NSV or Peercast ) 
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For existing video files (pre-encoded NSV files) use NSVscsrc 


- Preencode your video to NSV using nsvenc and place it in one directory 
- Use nsvscsrc and stream to the Peercast server. 

- Under DOS mode - use these syntax to stream files to peercast 

( You must be in the directory where nsvscsrc is located at. ) 


An 1x) 
i[S3|ea| Ea] sf Al 


Microsoft(R) Windows 98 
(C)Copyright Microsoft Corp 1981-1998. 





C2 \WINBOWS>ed \ 


C:\ed \Progranm Files\HSVUtools_ 


nsvscsrc localhost:7144:headers.txt (drive letter) (directory name) (file 
name . nsv) 


For live video ( from a video capture card ) use NSVCAP 


Start NSVCAP 


im NSVCAP |= |} x} 
Open NSV Tab Fie Dewces Options Ceptue NSV Heb 


Kensington Cabo Camera 
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It is preferable to use low bit rate settings for NSV broadcasting. You can find 
a copy of these settings on page 17, Low bit rate NSV_ configuration 
submitted by Jstar 


Select Config Tab 





Select video 
format : VP3.3.1 
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Select File Tab 


Select set capture destination 


Set Capture Destination 


The set capture destination window 
will open. 


You must input the following: 


Output Shoutcast host. 

( This will actually be Peercast ) 
Shoutcast server - localhost, 
Port - 7144, 

Password - Peercast password 
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Low bit rate NSV configuration submitted by |star 


[audio mp3l] 
conf=300000008000000080000000030000000500000005000000FFFFFFFF3 
9 


[video vp3] 
conf=800000003A000000C40000000100000001000000010000005A000000 
0 

80000007800000001000000010000005D 


[nsvconfig] 
audfmt=1815302221 
vidfmt=825446486 
minsync=0 
maxsync=120 
audiosendahead=0 
hdrwrite=0 
hdrtoc=1024 

meta= 


[nsvencpp] 
out_srate=44100 
out_channels=2 
sizefix=1 
deinterlace=0 
filteringresize=1 
doresize=1 
resizew=320 
resizeh=240 
crop_|l=0 

crop _t=0 
crop_r=0 

crop b=0 
outfruse=1 
lowpass=0 
audioscale=1.000 
outfror=15.0000000 
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Peercast Information 
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Finding Stations 


Stations broadcasting on Peercast can be found using 3 methods 







+: fundemental | dn (30 kb/s OGG) , 
. @ Station 83.4 im-kyoto (35 kb/s OGG) r 

The most reliable and easiest ComUnica Radio (24 kb/s MP3) ‘ 
method of finding a station is to Example stream@2ch (36 kb/s OGG) > 
left click on Peercast Icon in the icerdanbean? elas ae ae 2 
. . Campaneta ™ testing(04/20) ... is , 

tool bar. A popup display will Japanese TV - Live (200 kb/s NSV] 4 
appear. JODA BSN Niigata Housou (24 kb/s OGG) r 
JOQR@AM1134KHz [TokyoRadioetwor,.. (32 kb/s MP3} > 

' : Lota Munchen Programm vom Vortag (32 kb/s OGG) > 
Click on the station name to ~ MisFudgee Ptog {112 kb/s O66) § 
listen, go to the station web site robot-ch@{5/25 new 33 musics/tot.. (45 kb/s OGG) > 
( if they have one ) or get info on lbacepemdesnrialiseti aes (32 kb/s OGG) 2 
. ein 's » 

the station. a 
» 


\Wthout Names Radio [™ Goldra... (24 kb/s MP3) 
BS Radio|Reakime Radio Relay) (24 kb/s OGG) 


Find Channets 
‘Yellow Pagas 






3.41 Pte 


The next method is to right click on 
the Peercast icon: 


- Click on the Advanced tab. 
- Click on the All Channels tab. 


The All Channels administration 
page from Peercast will open and 
display channels on Peercast. 














The YP directory is the last S27 SB Sele 2) 





method. PS =) 


Peercast does not use a 
central server to exchange 
information. This might 
results in a time delay for 


«) peercast.org 


P2p broadcasting for everyone 


stations to appear on the YP Pape parent] Sarena) [as 
directory or not showing up Rardin 66 Srrwls. T9 bine vet, 130 otlaye. Lore gcetas O aac 

at all. Without a central zack 3) chennct Yale sivaie Dome 
server, the Peercast network Ri ec ce a ee 


i 
Hopleg Dare [Red taaten (Mi perberensed = ODOT CSE ID, [aranged 
Sees 


must wait for station data to 
propagate throughout the 
network. 


Reidel ealtieves Rardin Roba) 
®D Tuepo Japan 


wes . 
ave PShies ul top ns 2GFre ab SD) arse 

> (Fis) ke TRA FsOigconmericiearatns 83 4ind @ Felya) - FS kafettedeme a Bz bs) (ORO 
Fede Ootasd 








masts 117 1 nes 21 emir Mla ial ATA rreniass rereabl <=: = 
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Relaying A Station 


This method is used to relay an existing station currently streaming on the 
Internet. The station must be using a media encoding format that is 
supported by Peercast. 


The current encoding formats that are supported by Peercast are: 


- MP3 - NSV 
- Ogg Vorbis - Windows Media Audio 
To start, 


Right click on the Peercast Icon 


- Click on the Advanced tab. 
- Click on the Broadcast tab 


The Broadcast administration page 
from Peercast will open. 











The following information 
must be entered to relay: 











PeerCast.ors0 
URL - Address of the stream a am rc arin ra 
to be relayed. — 
Name — Name of station . aa | 
Description — Description of ooo 
station. a 
Genre - Type of program. a 
Contact - E Mail or web site J ooneee Rater | 
Bitrate - Speed of stream. — = — — = 
Type — Select the method of 
encoding. Pa rt 
asm) (AS ] [DjPectotn RES SSSSR WN Wear 


When you have entered in all data, click on the create relay button. 


If the relay is working, you will be able to view the station being relayed on 
the Peercast Admin - Relayed channels page. 
http://localhost:7144/admin?page=mychans 
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Private Peercast network 
You can create your own Peercast private network. 


This will require you to set up your copy of Peercast as a root system. 


Right click on the Peercast icon: 


- Click on the Advanced tab. 
- Click on the Settings tab. 


The Settings administration page 
from Peercast will open. 





2 PeeiCaszt on - Microsoft Internet Explorer 


Fie Edt View Favorites Tools Help 
£12.19 [218 La | 
Stop Refresh | Home — Favortes | History 





Bec Fervyatd Print 


‘Address [2 hilp:/Aocahoet:7144/ admin ?page=seltings =] eGo 
- 








PeerCast v.19 
Index Allchannels Relayed channels Broadcast Connections Settings View Log Logout 
Server Client 
Password | Auto Connect Come oF 
DJ Message | Lookup Host [connectt .peercastorg 
Type Normal Dead Hit Age (sec) fe00 
ICY Metalnterval farg2 Refresh HTML (sec) [5 
Mode © Normal 
© Root 





Mode must be changed from Normal to Root 
Auto Connect must be turned off 
Lookup Host must be cleared 


Any clients that desire to join your private Peercast network must manually 
change their lookup host from connect1.Peercast.org to the URL or IP address 
of the computer running the root Peercast software. 


Any stations that run on a private Peercast network will not be displayed on 
the public YP Directory service located at Peercast.org. 


If changes are made to your settings on this admin page, click on the Save 
Settings button at the bottom of the page. 
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Peercast connection problems 
If you are having trouble connecting with the Peercast network, you need to 
make sure that your Peercast software is configured correctly. 
Right click on the Peercast icon: 


- Click on the Advanced tab. 
- Click on the Settings tab. 


The Settings admin page from 
Peercast will open. 





You need to ensure that your Peercast filters and security settings are 
identical to the ones shown below. 


Filters Security 
IP Mask Network Direct Private Ban Allow on port: 7144 7145 
255.255.255.255 Vv T- a . HTML a 1_| 
127.001 Vv Vv Vv 7 Broadcasting Iv VV 
r..COtCSstSSS r r r r Servents Vv in 
Data Iv TC 


Firewall security software users. 


If you are running a security firewall on your computer, you need to ensure 
that ports 7144 and ports 7145 are open and allow traffic for Peercast. 


If changes are made to your settings on this admin page, click on the Save 
Settings button at the bottom of the page. 
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Additional information for the settings admin page 


Network 


Max. Outgoing 
Max. Incoming 
Max. Tryout 


Min. Connected 


may 


Max. Bandwidth/Conn. (bits/s) 


The max outgoing is the max 
number of outgoing data requests. 


The max incoming is the max 
number of incoming data requests. 
The max tryout is how many hosts 
you can try at any one time. 

The min. connected is the least 
number of connections you can 
have. 

The Max bandwidth/Con is the max 


bandwidth available. 


Authentication 
icy 
HTML Authentication Cookies 
™ Basic HITP 
i * Bnd of session 
Cookies Expire 
e © Never 


Determines the method of 


authentication procedure for logging 


onto the admin page remotely. 
The recommended settings are 
- Authentication method cookies 
- Cookie expires end of session 


Relay 


la 
: P 
Eee er fo 


Max. Output (Kbits/s) fi 26 
[300 
[300 


The max total streams is the total 
number of allowed relay streams 
The max streams per channel is the 
total number of allowed streams for 
each channel 

The max output is total bandwidth 
allowed for relays 


The preview time is 


Max. Total Streams 


Preview Time (sec) 


Preview Wait (sec) 


The preview wait is 


Log 
Debug Cj 
Errors a 
Network a 
Channels i | 


Enables the logging of activity for 
the specific area checked. 


If changes are made to your settings on this admin page, click on the Save 
Settings button at the bottom of the page. 


23 


Winamp Peercast Plug-in 


Peercast has a Winamp plug-in that will allow you to broadcast and receive 
stations using Peercast. 


Download the latest copy of the Winamp plug-in 
Install the plug-in 


PeerCast (Betal) 
— Chant / Server—[¥ Active 


Pot: [rise Password: [ 


Display channels in Miriteowser 





Ensure that the Client / Server box is checked 

The port number should be 7144 

The password should be left blank 

Enter the maximum Internet bandwidth capacity 

Check the appropriate Internet connection you have 

Enter in the name of your station 

Enter in the genre or type of station you are 

Enter in the URL of the stations web page 

Quality refers to the encoding quality of your stream based upon your 
network speed. 


Clicking on the advanced settings will open the Settings admin page. 


Click the apply button and then okay to save any settings that you enter or 
change. 


Peercast will display a station directory in the Winamp mini browser. 
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General Information 
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Best Broadcasting Practices 


HendrikMans 


Don't use high bitrates! 


This is probably the most important tip for broadcasters. A stream's bitrate, 
usually specified as "kbit/s" or "kbps", is the number of bits per second used. 
| am about to tell you to use low bitrates. You may be worried that those will 
make your stream sound like poop, but bear with me. First, a quick 
explanation! 


When broadcasting via PeerCast, you have to consider two things: a) you 
have to be able to upload at least one copy of your stream, better two, plus 
some overhead; so if you have a 128kbit/s upload cap (which is the case for 
most DSL or Cable connections), you will want to choose a birate for your 
stream that is lower than that, maybe even low enough so you can upload 
two copies at once. And, more importantly, b) you have to keep in mind that 
each of your listeners should be able to upload at least one copy of your 
stream, too; better two (or more). This is very important because PeerCast 
relies on the principle that every listener is also a relay! 


Now, if you think about what kind of upload capacities most users have, you 
will easily understand why broadcasting using, for example, 128kbit/s MP3 is 
a really, really bad idea, unless you have enough bandwidth yourself to 
support all listeners (but in that case, you wouldn't need or want to use 
PeerCast, anyway). 


Now, those of you who've only been using MP3 so far will probably be worried 
that their streams will sound really bad at lower bitrates, but there is a rather 
simple solution: instead of MP3, use OggVorbis! PeerCast has built-in support 
for this free audio codec, and most popular media players can play it (the 
significant exception at this point being WindowsMediaPlayer, but Ogg Vorbis 
streaming support is already being worked on). The wonderful thing about 
OggVorbis is that it sounds a lot better at lower bitrates than MP3 ever did; as 
a general rule of thumb, OggVorbis needs only slightly more than half the 
bitrate of MP3 to achieve the same kind of sound quality. 
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To sum it all up: for your high quality broadcasts, don't use 128kibt/s MP3, 
but 64kbit/s OggVorbis. The sound quality will be roughly the same, and your 
stream will have a much easier time to propagate through the PeerCast 
network. 


Use a channel title and genre that makes sense! 


This is really a no-brainer, but it never hurts to repeat it. When broadcasting, 
keep in mind that your channel will be displayed in every PeerCast user's 
channel list, as well as the PeerCastYP. If you want to get listeners, don't 
name your channel "My channel" or "asdfqwerty"; try giving it a meaningful 
name, and also setting a genre that roughly matches the kind of music/other 
audio material you're playing. 
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Channel ID Guide 


HendrikMans 


The channel ID is a 32 character string used by PeerCast to uniquely identify 
streams on the PeerCast network. You've probably noticed them before -- 
yes, those nasty looking things F9542853E84858600C7F37572E288485. The 
nice thing about them is that they refer to the channel from every point 
within the PeerCast network. You can use them in peercast:// style links to tell 
PeerCast to start playing a stream. 


No matter if you're broadcasting yourself, or just relaying someone else's 
channel, you can find each channel's Channel ID by clicking the "Info" link in 
your local PeerCast's "Relayed Channels” or "Available Channels" lists. 


Now, if you're a broadcaster, you will have to be aware that the channel ID 
for your station can change under certain circumstances. When you're using 
peercast:// links to send listeners to your station from your website, you will 
want to make sure your ID doesn't change too often! 


Fortunately, there is nothing random to how the IDs are generated, so you 
have pretty good control over them. 


What you need to know is that the channel ID is generated by throwing three 
pieces of information together and encoding them into a 16 byte 
hexadecimal value: 


Your channel name; 

The stream's bitrate; 

The stream's mountpoint; 
Your IP address. 


Don't worry about the latter -- it is impossible to calculate any of these values 
from the channel ID. However, it also means -- and this is the important bit -- 
that whenever one of these values changes, your channel ID changes. What 
this means is that as soon as you 
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Change your channel's name 
Switch your stream to another bitrate 
Use a different mountpoint or 
reconnect with a different IP address, 


your channel ID will change, and all the peercast:// links you've given out 
already will be invalidated. 
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Using peercast:// links 

HendrikMans 

peercast:// links are an exciting new feature in version 0.110. Basically, this 
new feature allows you to directly link to your audio stream from your 
website. Instead of telling your listeners to first "get" your channel, then wait 
until it is marked as "RECEIVE", and then click on "Play", you can now simply 
link to your stream directly, using the new peercast:// URLs. 
Basically, the format of a peercast:// URL is: 
peercast://pls/<channel ID> or <channel name> 
For example, if your station ID is 9CB8167E9EA18BOEDEBDCB4ADOFE6B39, 
your peercast:// URL would be: 


peercast://pls/9CB8167E9EA18BOEDEBDCB4ADOFE6B39 


You can find out your stream's channel ID on the "Relayed Channels" page in 
your PeerCast's web interface, in the links used in the "Stream" column. 


Now, in order to send your listeners to your channel, just put a link on your 
station's website like this: 


<a href="peercast://pls/9CB8167E9EA18BOEDEBDCB4ADOFE6B39"> 

Listen to my station!</a> 

or 

<a href="peercast://pls/myradio">Listen to my station! </a> 

When someone clicks that link, his PeerCast will intercept it and 


automagically start playing your channel. Nice eh? The only drawback is that 
your listeners obviously need to have PeerCast installed already. 
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Feedback 


This will be a work in progress that will be revised and updated as Peercast is 
updated and improved. 


If you would like to see additional subjects covered please feel free to submit 
the ideas in the Peercast forum. 


Please give as much detailed information as possible. Any information should 
be accompanied with detailed instructions and graphic pictures. 


Non-Windows operating system information for Peercast is gladly welcome. 
If you find any errors or would like to include any additional information 


regarding a topic, please indicate the topic and the page number along with 
the additional information or error to be corrected. 


